본문으로 건너뛰기

Google Workspace API 할당량 안내

정보

Google Drive API 요청 한도에 걸리면 SHIELD DRM이 자동으로 재시도하므로 문서는 늦게라도 처리됩니다. 관리자가 조치할 일은 거의 없습니다. 다만 대량 업로드 직후에는 반영이 늦어질 수 있으며, 24시간 안에 처리되지 않은 문서는 재시도를 멈춥니다.

이 문서는 Google Workspace 환경 기준입니다. Microsoft 365 환경의 요청 제한은 「MS Throttling 안내」를 참고하십시오.

Google Drive API 할당량이란​

SHIELD DRM은 Google Drive API로 변경 내역을 조회하고, 문서를 내려받아 처리한 뒤 다시 올립니다. Google은 서비스 안정성을 위해 이 API에 요청 할당량(Quota) 을 둡니다.

  • 할당량은 프로젝트 단위와 사용자 단위로 적용됩니다. 짧은 시간에 요청이 몰리면 Google이 일부 요청을 거절합니다.
  • 거절 응답은 429 Too Many Requests 또는 403(rateLimitExceeded · userRateLimitExceeded)입니다.
  • 한도 수치는 Google이 정하며 바뀔 수 있습니다. 최신 값은 Google 문서 Usage limits를 참고하십시오.

SHIELD DRM이 사용하는 Google Cloud 프로젝트는 SHIELD DRM 서비스가 운영합니다. 고객사가 할당량을 따로 신청하거나 조정할 필요는 없습니다.

SHIELD DRM의 대응​

한도 초과 시 자동 재시도​

요청이 한도에 걸리면 SHIELD DRM은 해당 작업을 지수 백오프(Exponential Backoff) 방식으로 다시 시도합니다.

항목동작
재시도 대상할당량 초과(429, 403 요청 한도 사유), Google 서버 일시 오류(5xx)
재시도 간격15초에서 시작해 시도할 때마다 두 배로 늘어나며, 최대 30분입니다
재시도 중단처음 요청 후 24시간이 지나면 더 이상 재시도하지 않습니다
  • 변경 내역 조회가 한도에 걸리면, 마지막으로 처리를 마친 지점부터 다시 조회합니다. 감지한 변경이 누락되지 않습니다.
  • 권한 부족처럼 다시 시도해도 해결되지 않는 오류는 재시도하지 않습니다.

변경 알림 채널의 만료와 재등록​

드라이브에 설치하는 변경 알림 채널은 Google 정책상 최대 7일 동안만 유효합니다. SHIELD DRM은 15분마다 채널을 점검해 만료까지 1일 이내로 남은 채널을 자동으로 재등록합니다. 관리자가 주기적으로 재설치할 필요는 없습니다.

대량 변경 처리​

많은 문서가 한꺼번에 올라오면 SHIELD DRM은 변경 내역을 차례로 나누어 조회·처리합니다. 이때 정책 반영이 평소보다 늦어질 수 있습니다. 모든 변경은 순서대로 처리됩니다.

관리자가 체감하는 증상과 대응​

증상원인대응
업로드한 문서의 암호화 해제가 평소보다 늦음대량 업로드로 할당량 초과 또는 처리 대기조치 없이 기다립니다. 자동 재시도로 처리됩니다
하루가 지나도 문서가 처리되지 않음24시간 동안 재시도했으나 처리하지 못함「문서 변환 로그」에서 결과를 확인합니다. 문서를 다시 올리거나 저장해 새 변경을 만들면 다시 처리 대상이 됩니다
특정 드라이브의 문서만 전혀 처리되지 않음할당량 문제가 아니라 채널 미설치 또는 권한 문제일 가능성이 큼「Google Drive 이벤트 채널」에서 해당 드라이브의 채널 설치 상태를 확인합니다
새로 만든 공유 드라이브가 처리되지 않음새 공유 드라이브에는 채널이 자동으로 설치되지 않음관리자 페이지에서 동기화 후 채널을 설치합니다
관리자 페이지의 동기화를 연달아 누르면 거부됨목록 동기화는 1분에 한 번만 실행할 수 있음1분 뒤 다시 실행합니다
경고

문서가 처리되지 않을 때 가장 흔한 원인은 할당량이 아니라 채널 미설치입니다. 반영 지연을 할당량 탓으로 판단하기 전에 채널 설치 상태부터 확인하십시오.

참고 문서​